سلام! اگر می خواهید نحوه استفاده از روش append()  را بیاموزید ، این مقاله برای شما مناسب است. این یک روش قدرتمند است که شما قطعاً در پروژه های پایتون خود استفاده خواهید کرد.

آنچه در این مقاله یاد خواهید گرفت:

• چرا و چه زمانی باید از append() استفاده کنید.
• چگونه آن را فراخوانی کنیم.
• اثر و مقدار بازگشت آن.
• چگونه می تواند معادل insert()  و برش رشته با آرگومان های مناسب باشد.

شما می توانید نمونه هایی از کاربرد append() را که برای رشته ها ، اعداد صحیح ، اعداد اعشاری ، بولین ها ، لیست ها ، tuples و dictionaries اعمال می شود ، پیدا کنید.

هدف

با استفاده از این روش می توانید یک عنصر واحد را به انتهای لیست اضافه کنید.

در اینجا می توانید تأثیر append()  را به صورت گرافیکی مشاهده کنید:

نکته: برای افزودن دنباله ای از عناصر منفرد ، باید از روش extend()  استفاده کنید.

نحوه نگارش و پارامترها

این نحو اساسی است که برای فراخوانی این روش باید از آن استفاده کنید:

 نکته: نقطه از اهمیت زیادی برخوردار است ، زیرا ()append  یک روش است. وقتی متدی را فراخوانی می کنیم ، از نقطه بعد از لیست استفاده می کنیم تا نشان دهیم می خواهیم آن لیست خاص را "اصلاح" یا "تأثیر بگذاریم".

همانطور که مشاهده می کنید ، روش append() فقط یک آرگومان را می گیرد ، عنصری که می خواهید اضافه کنید. این عنصر می تواند از هر نوع داده باشد:

• Integer
• String
• Float
• Boolean
• Another list
• Tuple
• Dictionary
• An Instance of a custom class

در واقع ، هر مقداری که می توانید در پایتون ایجاد کنید ، می تواند به لیستی اضافه شود.

مثال

این نمونه ای از فراخوانی برای append() است:

 musical_notes = ["C", "D", "E", "F", "G", "A"]

 musical_notes.append("B")

• ابتدا لیست تعریف شده و به یک متغیر اختصاص داده می شود.
• سپس ، با استفاده از این متغیر ، متد append() را فراخوانی می کنیم و عنصری را که می خواهیم اضافه کنیم (رشته "B") را به عنوان آرگومان منتقل می کنیم.

 اثر و مقدار بازگشت

این متد لیست اصلی را در حافظه تغییر می دهد. نسخه جدیدی از لیست را بر نمی گرداند ، هرچند ممکن است فکر کنیم ،  None را بر می گرداند. بنابراین ، با فراخوانی این متد در حال اصلاح لیست اصلی هستید.

در مثال قبلی ما:

 musical_notes = ["C", "D", "E", "F", "G", "A"] 

("musical_notes.append("B  

می توانید (در زیر) مشاهده کنید که لیست اصلی پس از الحاق المان ، اصلاح شده است. آخرین عنصر اکنون "B" است و لیست اصلی اکنون نسخه اصلاح شده است.

 musical_notes

['C', 'D', 'E', 'F', 'G', 'A', 'B']

با اختصاص این مقدار به یک متغیر و چاپ آن ، می توانید تأیید کنید که مقدار برگشتی append()  برابر None  است.

 musical_notes = ["C", "D", "E", "F", "G", "A"]

 a = musical_notes.append("B")

 print(a)

None

مثالها

اکنون که هدف ، نحوه نگارش و تأثیر روش append() را دانستید ، بیایید چند نمونه از کاربرد آن را با انواع مختلف داده مشاهده کنیم.

یک رشته را اضافه کنید

 top_players = ["gino234", "nor233", "lal453"]

 top_players.append("auop342")



# The string was appended

 top_players

['gino234', 'nor233', 'lal453', 'auop342']

یک عدد صحیح اضافه کنید

 data = [435, 324, 275, 567, 123]

 data.append(456)



 data

[435, 324, 275, 567, 123, 456]

یک عدد اعشاری را اضافه کنید

 data = [435.34, 324.35, 275.45, 567.34, 123.23]

 data.append(456.23)



 data

[435.34, 324.35, 275.45, 567.34, 123.23, 456.23]

یک مقدار بولین اضافه کنید

 values = [True, True, False, True]

 values.append(False)



 values

[True, True, False, True, False]

یک لیست اضافه کنید

این روش یک عنصر واحد را به انتهای لیست اضافه می کند ، بنابراین اگر لیستی را به عنوان آرگومان منتقل کنید ، کل لیست به عنوان یک عنصر واحد اضافه می شود (این یک لیست تو در تو در لیست اصلی خواهد بود).

data = [[4.5, 4.8, 5.7], [2.5, 2.6, 2.7]]

 data.append([6.7, 2.3])



 data

[[4.5, 4.8, 5.7], [2.5, 2.6, 2.7], [6.7, 2.3]]

یک   Tuple اضافه کنید

کل تاپل به عنوان یک عنصر واحد اضافه می شود.

 data = [[4.5, 4.8, 5.7], [2.5, 2.6, 2.7]]

 data.append((6.7, 2.3))



 data

[[4.5, 4.8, 5.7], [2.5, 2.6, 2.7], (6.7, 2.3)]

 نکته: اگر لازم است عناصر یک لیست یا tuple را به عنوان عناصر جداگانه لیست اصلی اضافه کنید ، باید به جای append() از روش extend()  استفاده کنید. برای کسب اطلاعات بیشتر در مورد این ، می توانید مقاله من را مطالعه کنید:

یک ِDictionary اضافه کنید

بطور مشابه ، اگر یک dictionary اضافه کنید، کل dictionary  به عنوان یک عنصر واحد اضافه می شود.

 data = [{"a": 1, "b": 2}]

 data.append({"c": 3, "d": 4})

 data

[{'a': 1, 'b': 2}, {'c': 3, 'd': 4}]

 معادل سازی Append و Insert

نکته جالب این است که اگر آرگومان های صحیح را منتقل کنیم ، روش ()insert  می تواند معادل  append()باشد.

متد insert() برای قرار دادن عنصری در یک شاخص (موقعیت) خاص در لیست استفاده می شود.

این نحو نگارشی است که برای فراخوانی روش insert() استفاده می شود:

برای معادل سازی آن با append():

• مقدار شاخص باید طول لیست باشد (len (<list>)) زیرا ما می خواهیم این عنصر آخرین عنصر لیست باشد.

در اینجا مثالی آورده شده است که نشان می دهد نتیجه استفاده از insert با این آرگومان ها معادل  append()است:

 musical_notes = ["C", "D", "E", "F", "G", "A"]

 musical_notes.insert(len(musical_notes), "B")

 musical_notes

['C', 'D', 'E', 'F', 'G', 'A', 'B']

اما همانطور که مشاهده کردید ، ()append بسیار خلاصه و کاربردی تر است ، بنابراین معمولاً توصیه می شود در این حالت از آن استفاده کنید.

 معادل Append و برش لیست(List Slicing)

همچنین یک برابری جالب بین روش ()append و برش لیست وجود دارد.

این نحو اساساً لیستی را که شامل عنصر [<elem>] به عنوان آخرین قسمت (انتهای) لیست است اختصاص می دهد. در اینجا می بینید که نتیجه معادل ()append است:

 musical_notes = ["C", "D", "E", "F", "G", "A"]

 musical_notes[len(musical_notes):] = ["B"]

 musical_notes

['C', 'D', 'E', 'F', 'G', 'A', 'B']

اینها گزینه های جالبی هستند ، اما برای اهداف عملی ما معمولاً از append() استفاده می کنیم زیرا این یک ابزار بسیار گرانبها است که پایتون ارائه می دهد. استفاده از آن دقیق ، مختصر و آسان است.